home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / perror.man < prev    next >
Encoding:
Text File  |  1989-01-06  |  1.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. PERROR                C Library Procedures                 PERROR
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      perror, sys_errlist, sys_nerr - system error messages
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ppeerrrroorr((ssttrriinngg))
  13.      cchhaarr **ssttrriinngg;;
  14.  
  15.      iinntt ssyyss__nneerrrr;;
  16.      cchhaarr **ssyyss__eerrrrlliisstt[[]];;
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      _P_e_r_r_o_r produces a short error message on the standard error
  20.      file describing the last error encountered during a call to
  21.      the system from a C program.  If _s_t_r_i_n_g is non-NULL, it is
  22.      printed, followed by a colon, followed by a space, followed
  23.      by the message and a new-line.  Otherwise, just the message
  24.      and the new-line are printed.  Most usefully, the argument
  25.      string is the name of the program which incurred the error.
  26.      The error number is taken from the external variable _e_r_r_n_o
  27.      (see _i_n_t_r_o(2)), which is set when errors occur but not
  28.      cleared when non-erroneous calls are made.
  29.  
  30.      To simplify variant formatting of messages, the vector of
  31.      message strings _s_y_s__e_r_r_l_i_s_t is provided; _e_r_r_n_o can be used
  32.      as an index in this table to get the message string without
  33.      the newline.  _S_y_s__n_e_r_r is the number of messages provided
  34.      for in the table; it should be checked because new error
  35.      codes may be added to the system before they are added to
  36.      the table.
  37.  
  38. SSEEEE AALLSSOO
  39.      intro(2), psignal(3)
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0            September 10, 1987                       1
  64.  
  65.  
  66.  
  67.